ActiveX Document Migration Wizard

The ActiveX Document Migration Wizard is designed to help you change your existing forms into ActiveX documents. An ActiveX document is a specific type of ActiveX object that can be placed and activated within ActiveX document containers such as the Microsoft Internet Explorer.

Note   The ActiveX Document Migration Wizard converts forms to document objects but does not create an ActiveX Document-based application from your form-based project.

When you convert a form to an ActiveX document, the ActiveX Document Migration Wizard:

•	Copies the form properties to a new user document.

Menu items are retained. If you have duplicate menus, both will appear in the browser unless you manually remove the one on your form. The exception to this is the Help menu which is merged between the container and the ActiveX document.

•	Copies all controls, using the same names, from the form to the user document.

Controls remain in the same position and retain the same properties.

•	Does not support OLE embeddings.

•	Converts form event handlers into ActiveX Document object event handlers as the code is being copied. Event handler names are renamed appropriately for ActiveX documents. The ActiveX Document Migration Wizard does not automatically remove non-supported event handlers such as Load and Unload.

Copies the code behind the form to the user document. Code that is not supported by user documents such as Show and Hide methods, and End statements will be commented out. You will get compile-time errors for other code that is not compatible between ActiveX documents and forms.

The ActiveX Document Migration Wizard has the following steps:

Introduction

Form Selection

Options

Finished

Summary Screen


ActiveX Document Migration Wizard-Form Selection
ActiveX Document Migration Wizard—Form Selection

Allows you to select the forms you want to convert to ActiveX documents.

Wizard Options

Forms List   Lists the available forms in the current project that you can convert to ActiveX documents. You can choose one or more forms by clicking the check box for each form you want.

Help   Opens the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Document Migration Wizard.

Back   Moves you to the previous step.

Next   Disabled in this step.

Finish   Converts the selected forms into ActiveX documents using the default values, and adds them to the ActiveX documents folder in the Project Explorer. If there is no ActiveX document folder, one is created.


ActiveX Document Migration Wizard-Introduction
ActiveX Document Migration Wizard—Introduction

Helps you convert your current project forms into ActiveX documents.

Wizard Options

Skip this screen in the future   When selected, the ActiveX Document Migration Wizard will not show the Introduction screen the next time you start it.

If you want to see this screen in the future, click the Back button on the first step of the wizard.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Document Migration Wizard.

Back   Disabled in this step.

Next   Moves you to the next step.

Finish   Unavailable because you have not provided enough information for the ActiveX Document Migration Wizard to create an ActiveX document using default values.


ActiveX Document Migration Wizard-Finished!
ActiveX Document Migration Wizard—Finished!

Creates ActiveX documents for the selected forms and allows you to obtain a summary report that contains information on additional steps to take.

Wizard Options

Would you like a Summary Report with instructions on what to do after the wizard is done?

•	Yes — Generates a summary report. This is the default.

•	No — No summary report is generated.

Save current settings as default   If selected, the current settings are saved and used each time you use the ActiveX Document Migration Wizard until you save new settings.

Help   Displays the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Document Migration Wizard.

Back   Moves you to the previous step.

Next   Disabled in this step.

Finish   Creates an ActiveX document based on the settings you selected.


ActiveX Document Migration Wizard-Options
ActiveX Document Migration Wizard—Options

Allows you to have specific unsupported code comments out and to remove the original forms from the project after conversion.

Wizard Options

Comment out invalid code?   When selected, the ActiveX Document Migration Wizard comments out all of the following code for the selected forms and creates an ActiveX EXE or ActiveX DLL:

•	Form.Show and Form.Hide

•	Me.Show and Me.Hide

•	Form.Load and Form.Unload

•	Me.Load and Me.Unload

•	End

Remove original forms from project after conversion?   Removes the selected forms from the project but not from your disk, after conversion.

Your Project Type is invalid   You are trying to create an ActiveX document from a standard EXE or ActiveX Control project. You must convert your project to either an ActiveX EXE or ActiveX DLL project.

Convert to an ActiveX EXE Project? — Converts your project to an ActiveX EXE. This is the default.

Convert to an ActiveX DLL Project? — Converts your project to an ActiveX DLL.

Help   Opens the help topic for this step. You can also press F1 for help.

Cancel   Cancels your previous actions and closes the ActiveX Document Migration Wizard.

Back   Moves you to the previous step.

Next   Moves you to the next step.

Finish   Converts the selected forms into ActiveX documents using the default values, and adds them to the ActiveX documents folder in the Project Explorer. If there is no ActiveX document folder, one is created.